home *** CD-ROM | disk | FTP | other *** search
/ Print & Paint Power / Print & Paint Power.iso / hitech / clip / catalog / sgif.doc < prev    next >
Text File  |  1992-10-11  |  12KB  |  330 lines
  1.  
  2. The author makes NO WARRANTY or representation, either express or implied,
  3. with respect to this software, its quality, accuracy, merchantability, or
  4. fitness for a particular purpose.  This software is provided "AS IS", and you,
  5. its user, assume the entire risk as to its quality and accuracy.
  6.  
  7. Here is SGIF v1.8, the GIF viewer that lets you look at the current GIF
  8. in a slide show while decoding the next one to XMS or EMS memory.  When
  9. you hit the ENTER or SPACE key, it (almost) immediately displays the
  10. pre-decoded gif, and automatically decodes the next one in the slide
  11. show.  This way, you don't have to wait.  The first gif in the show is
  12. sent to the screen while it's being decoded.  It can also look for the
  13. gifs in multiple directories that you specify on the command line.
  14.  
  15. SGIF requires a 286 or better CPU, 768K free EMS or XMS memory, and one
  16. of the following video boards:
  17.  
  18. Tseng Labs ET4000 (Diamond, Orchid, STB, Simga, etc.)
  19. ATI VgaWonder
  20. Paradise SVGA
  21. Diamond Speedstar 24X
  22.  
  23. It will read GIF87a or GIF89a files, but it cannot do the fancy GIF89
  24. stuff.
  25.  
  26. SGIF is not public domain.  You can freely distribute it, but if you like
  27. it and use it often, please send an appreciation of $15 to:
  28.  
  29. Bailey Brown
  30. 188 Morris Rd
  31. Toney, Alabama 35773 USA
  32.  
  33. e-mail:
  34.  
  35. 73020,3442                    (CompuServe)
  36.  
  37. New SGIF 1.8
  38.  
  39. Fixed a bug that caused the file selection screen to become garbled when
  40. there were over 125 but fewer than 151 filenames displayed.
  41.  
  42. I believe I have solved the snow problem on the 24X, so you may want to
  43. try /XN if you have been using /XS.
  44.  
  45. New SGIF 1.7
  46.  
  47. Added options 'S' and 'N' to Diamond Speedstar 24X switch '/X' to enable
  48. snow checking.  This only applies to the 1024x768x256 mode when decoding
  49. the first image in a slideshow to the screen, one scanline at a time.
  50. The snow checking is optional, because it slows the display down some
  51. (only in the above mentioned instance) and the snow isn't always visible
  52. without it.  The entire option for a 24X to check for snow is '/XS' and
  53. to not check for snow '/XN' (case does not matter).
  54.  
  55. Added support for the 132x25 and 132x44 text modes for the 24X.  I am
  56. not sure if these will also work with the Paradise or not.
  57.  
  58. New SGIF 1.6:
  59.  
  60. Paradise support really works now, or rather, it works on the Diamond
  61. Speedstar 24X, which is supposed to be backward compatible with the
  62. Paradise SVGA.
  63.  
  64. Diamond Speedstar 24X is now supported.  For now, only the 256 color
  65. modes are supported, up to and including 1024x768x256.  Version 2.0 will
  66. support the 640x480x24bit and 800x600x32K modes and also read 24bit
  67. unmapped TARGA files and JPEG files. SGIF 2.0 may be called something
  68. else, and it will be shareware.  This release, 1.6, will be the last
  69. feature enhancement release to the free SGIF.
  70.  
  71. Since the code I have cannot distinguish between a Paradise SVGA and
  72. the SS24X, use the /X option to indicate that you have a 24X.
  73.  
  74.  
  75. New SGIF 1.5:
  76.  
  77. Added Paradise SVGA support (640x400x256 and 640x480x256 modes only).
  78.  
  79. SGIF now has an option, /U, which causes it to "touch" the dates of
  80. files as they are viewed in a slideshow picked from the selection
  81. screen, but not from the command line or in preview mode.  This way,
  82. if you sort your directory listing by time, the gifs that appear last
  83. will be the ones you haven't looked at in a while, which you may want
  84. to delete.
  85.  
  86. New SGIF 1.4:
  87.  
  88. Fixed a bug that prevented SGIF from working with gifs in root directories.
  89.  
  90. New SGIF 1.3:
  91.  
  92. SGIF now stores fully expanded pathnames to each directory.  This
  93. eliminates a source of confusion that was causing problems with earlier
  94. versions.
  95.  
  96. New SGIF 1.2:
  97.  
  98. Allows you to insert new choices into the middle of your selection list.
  99. Just go to the selected filename that you want to come after the new
  100. selection, press the "insert" key, and then select the new file in
  101. the regular fashion.  While you are in "insert mode", an 'I' will appear
  102. in the upper-right corner of the screen.
  103.  
  104. There is a new command line option /C, which displays filenames in
  105. different colors corresponding to the directories they are in so you can
  106. see which ones are in the same directory
  107.  
  108. Added a "shell to dos" command alt+s.  It works only from the selection
  109. screen.
  110.  
  111. The info command now displays "GL" if the file has been compressed
  112. by giflite and has the giflite header.
  113.  
  114. Fixed some bugs with switching resolutions and with interlaced gifs that
  115. were larger than the screen.
  116.  
  117. New SGIF 1.1:
  118.  
  119. It will allow you to display info on a GIF file, and it also allows you
  120. to delete a file. 'i' = info  control+d = delete
  121.  
  122. SGIF 1.0:
  123.  
  124. One neat feature is that it allows you to specify multiple paths on the
  125. command line, so that you can browse through all of your gifs at once, even
  126. if they are split among several directories.
  127.  
  128. It has a very good interactive slideshow capability.  You can return to the
  129. previous gif, reverse direction, remove files from the slideshow, have
  130. an automatic slideshow and specify the delay between pictures, pause an
  131. automatic slideshow, and preview a gif without clearing your current
  132. slideshow selections.
  133.  
  134. Your can switch resolutions on the fly.  In this case, the gif is copied
  135. from the screen to XMS/EMS, then the mode is switched, then the gif
  136. is displayed, saving you the decoding time.
  137.  
  138. It will use the higher text modes (80x50, 132x25, 132x44) if they are needed
  139. to display all of the files on the screen.  The maximum is 484 files in
  140. 132 cols x 44 lines mode.
  141.  
  142. Before you go any farther, I want to make it clear that I wrote this
  143. viewer for my system.  It requires 768K free XMS or EMS memory, and that
  144. you have a Tseng Labs ET4000-type SVGA card (STB, Orchid ProII, Sigma,
  145. SpeedStar, etc.) or an ATI VGA Wonder compatible card (it's been tested
  146. extenively with Tseng ET4000, and only casually with VGA Wonder).
  147. It handles the 16-color modes poorly because I don't care about them.
  148.  
  149. If you like SGIF and would like to run it on a sysem with an unsupported
  150. video card, send me a $15 appreciation and I will port it to your new
  151. type of card.
  152.  
  153. A more complete description of the features follows.
  154.  
  155.  
  156. COMMAND LINE OPTIONS (not case sensitive)
  157. =========================================
  158.  
  159. * means default
  160.  
  161. /X[S|N]  Tells SGIF you have a Diamond Speestar 24X.  This switch is
  162.          neccessary because SGIF will detect a 24X as a Paradise SVGA.
  163.          It will still work in this case, but you will not be able to
  164.          use the 24X's extended modes.
  165.  
  166.          The 'S' option tells SGIF to check for snow in 1024x768x256 mode
  167.          when decoding the first image in a slideshow to the screen, one
  168.          scanline at a time.  Snow checking is never needed otherwise.
  169.  
  170.          Then 'N' option tells it not to check for snow.  It is best
  171.          to try it this way first.
  172.  
  173.  
  174. /V[:]x    default Video mode (colon is optional) where x is one of the
  175.           following:
  176.  
  177.           *default (no /v option given) is to use automode, meaning
  178.            lowest mode that will show whole picture is used.
  179.  
  180.            letter       horizontal      vertical        colors
  181.  
  182.            G            640             350             16
  183.            M            640             480             16
  184.            L            320             200             256
  185.            R            640             400             256 (ATI &PARADISE)
  186.            S            640             480             256
  187.            T            800             600             256 (TSENG & ATI)
  188.            X           1024             768             256 (TSENG & ATI)
  189.            1            next higher resolution than the one that
  190.                         the image will fit in, eg 800x600 for 640x480 gifs
  191.                         and 1024x768 for 800x600 gifs.
  192.  
  193. /B[d|n]  Background color
  194.  
  195.        *none   use background color specified in the gif header
  196.                 (not necessarily color 0 from the color map, which
  197.                 most gif viewers do).
  198.  
  199.         D      find darkest color in colormap and use it for the background
  200.  
  201.         n      where n is a number.  Use color n in the color map for
  202.                the background.  n must be in the range [0-nn]  where nn
  203.                is one less than the number of colors in the image (usually
  204.                15 or 255).
  205.  
  206.                 examples:
  207.                 sgif       will use color from gif header
  208.                 sgif /bd   will use darkest color possible
  209.                 sgif /b0   will use color 0 (usually black)
  210.                 sgif /b255 will use color 255 (usually white)
  211.  
  212. /Dpath1;path2;..;pathn
  213.  
  214.         specify Directories to look for gifs.  Does not assume current directory.
  215.  
  216.         example:
  217.  
  218.         sgif /d.;c:\pix\people;c:\pix\places;c:\pix\things;..\morepix
  219.  
  220.         will allow you to select gifs from the current directory and
  221.         the directories c:\pix;people, c:\pix\places, c:\pix\things,
  222.         and ..\morepix.
  223.  
  224. /K      don't wait for Keypress between pictures (auto slideshow).
  225.  
  226. /Wn     Wait time.  Sets pause time to n 100ths of a second.
  227.         Useful with auto slideshow.
  228.  
  229. /R      Return to DOS after displaying picture.
  230.  
  231. /E      Leave picture on screen after exiting (don't clear screen).
  232.         Useful with /R option.
  233.  
  234. /M[x|e] Memory
  235.  
  236.        *X       use XMS memory
  237.         E       use EMS memory
  238.  
  239. /C      Display filenames in colors corresponding to the directories they
  240.         are in so you can see which ones are in the same directory.
  241.  
  242. SELECTION KEYS (not case sensitive):
  243. ====================================
  244.  
  245. ENTER   show selected image(s).
  246.  
  247. SPACE   mark image for slideshow.
  248.  
  249. PAGE UP move to top of screen.
  250. PAGE DN move to bottom of screen.
  251. HOME    move to first column.
  252. END     move to last column.
  253. ^HOME   move to tope left corner.
  254. ^END    move to bottom right corner.
  255.  
  256. INSERT  allows you to insert new choices into the middle of your
  257.         selection list. Just go to the selected filename that you want
  258.         to come after the new selection, press the "insert" key, and
  259.         then select the new file in the regular fashion.  While "insert"
  260.         mode is activated, an 'I' will appear in the upper-right corner
  261.         of the screen.
  262.  
  263. 'f'     type 'f' followed by any char to move highlight to first filename
  264.         on screen that starts with that char.  Good for moving around
  265.         quickly.
  266.  
  267. 'p'     preview image (show image witout clearing slideshow list).
  268.  
  269. '+'
  270. 'z'
  271.         make next higher resolution default (starts with 640x480x256).
  272. '-'
  273. 'x'     make next lowere resolution default.
  274.  
  275. 'i'     display info on file (path, resolution, colors, size)
  276.  
  277. ^D      delete file after prompting
  278.  
  279. alt+s   shell out to  dos.  Type 'exit' and 'enter' to return to sgif.
  280.  
  281. toggles:
  282.  
  283. 'a'     use auto resolution.
  284.  
  285. '1'     use next higher than auto resolution, eg. 800x600 for 640x480 gif.
  286.  
  287. 'd'     use darkest color in images as background.
  288.  
  289. 'k'     (don't) wait for keypress.
  290.  
  291. ESC     quit.
  292.  
  293.  
  294. INTERACTIVE KEYS (while viewing images)
  295. =======================================
  296.  
  297. '+'
  298. 'z'
  299.         change to next higher resolution.
  300. '-'
  301. 'x'
  302.         change to next lower resolution.
  303.  
  304. 'u'     unselect image, ie. remove it from slideshow.
  305.  
  306. 'i'     display info on file (path, resolution, colors, size)
  307.  
  308. ^D      delete file after prompting
  309.  
  310. BACKSPACE
  311.         go back to previous image
  312.  
  313. 'r'     reverse direction of slideshow.
  314.  
  315. ESC     stop decoding/viewing and return to selection menu.
  316.  
  317. toggles:
  318.  
  319. 'a'     use auto resolution.
  320.  
  321. '1'     use next higher than auto resolution, eg. 800x600 for 640x480 gif.
  322.  
  323. 'd'     use darkest color in images as background.
  324.  
  325. 'k'     (don't) wait for keypress.
  326.  
  327.  
  328.  
  329.  
  330.